package xx.services.page.inter;

import javax.ws.rs.FormParam;
import javax.ws.rs.PathParam;

/**
 * 列表对应的参数服务接口
 * 
 * @Path (Constants.RESTFUL_ROOT_PATH + "/page/param")
 * @author chenxiang 2010-12-20
 */
public interface IParamInterface
{
    /**
     * 获取一个列表参数详细信息。 <br>
     * 
     * @GET
     * @param paramId
     * @return 参数实体JSON数据
     * @author chenxiang
     */
    public String get(@PathParam("param_id")
    long paramId);

    /**
     * 修改一个列表参数demo。<br>
     * 
     * @PUT
     * @param paramId-@PathParam("param_id")
     *            参数ID
     * @param pagesize-@FormParam("pagesize")
     *            每页显示多少记录
     * @param pageno-@FormParam("pageno")
     *            从第几页开始取数据，取值范围：1-n
     * @param cond-@FormParam("cond")
     *            取值条件where标准条件表达式
     * @param orderfield-@FormParam("orderfield")
     *            排序字段，也就是SQL语句中order by {orderfield}
     * @param fields-@FormParam("fields")
     *            需要返回的字段集，默认返回所有
     * @param dateFormat-@FormParam("date_format")
     *            日期格式化字符串
     * @param dateFormat-@FormParam("float_format")
     *            数字格式化字符串
     * @return 新列表参数实体JSON数据
     * @author chenxiang
     */
    public String update(@PathParam("param_id")
    long paramId, @FormParam("pagesize")
    int pagesize, @FormParam("pageno")
    int pageno, @FormParam("cond")
    String cond, @FormParam("orderfield")
    String orderfield, @FormParam("fields")
    String fields, @FormParam("date_format")
    String dateFormat, @FormParam("float_format")
    String floatFormat);
}
